.. _参数说明: ************************************ 参数说明 ************************************ .. _ 参数列表: ============================================================================== 参数列表 ============================================================================== -------------------------------------------------------------------------------------------------------------------------------------------- - task_ -------------------------------------------------------------------------------------------------------------------------------------------- - sys.pseudoType_ - sys.structure_ - sys.symmetry_ - sys.functional_ - sys.spin_ -------------------------------------------------------------------------------------------------------------------------------------------- - cal.iniCharge_ - cal.iniWave_ - cal.cutoffFactor_ - cal.cutoff_ - cal.methods_ - cal.smearing_ - cal.sigma_ -------------------------------------------------------------------------------------------------------------------------------------------- - io.charge_ - io.elf_ - io.potential_ - io.wave_ -------------------------------------------------------------------------------------------------------------------------------------------- - scf.max_ - scf.min_ - scf.mixBeta_ - scf.mixType_ - scf.convergence_ -------------------------------------------------------------------------------------------------------------------------------------------- - relax.max_ - relax.freedom_ - relax.methods_ - relax.forceConvergence_ - relax.stepRange_ -------------------------------------------------------------------------------------------------------------------------------------------- - dos.range_ - dos.resolution_ - dos.project_ - dos.EfShift_ -------------------------------------------------------------------------------------------------------------------------------------------- - band.kpointsLabel_ - band.kpointsCoord_ - band.kpointsNumber_ - band.project_ -------------------------------------------------------------------------------------------------------------------------------------------- - potential.type_ .. _ 参数详细描述: ============================================================================== 参数详细描述 ============================================================================== -------------------------------------------------------------------------------------------------------------------------------------------- .. _task: **参数名称:** :guilabel:`task` **默认值:** 无 **可选值:** ``scf/relax/dos/band/potential/elf`` **描述：** :guilabel:`task` 参数表示计算的类型，必须设置； ``scf/relax`` 可以是从头计算（不需要设置 ``cal.iniCharge`` 和 ``cal.iniWave`` ）也可以导入电荷密度或波函数（设置 ``cal.iniCharge`` 和 ``cal.iniWave`` ）； ``dos/band/potential/elf`` 为后处理计算，必须要电荷密度在导入电荷密度的同时可选择性的导入波函数（必须设置 **cal.iniCharge** ，选择性设置 **cal.iniWave** ）； 当 **task=scf/realx** 时，默认输出 ``system.json`` ；当 **task=dos/band/potential/elf** 时，默认输出对应的 ``dos.json/band.json/potential.json/elf.json`` 等json文件； **案例:** task = scf -------------------------------------------------------------------------------------------------------------------------------------------- .. _sys.pseudoType: **参数名称:** :guilabel:`sys.pseudoType` **默认值:** -1 **可选值:** -1 **描述：** ``sys.pseudoType`` 参数为设置 **DS-PAW** 计算所需的赝势格式；-1表示使用DS-PAW内部赝势；目前DS-PAW支持 **H C N O Si P S Cr Mn Fe Co Ni Li Na Ti Al Cu Zn Ga As Mo Ag Au** 23种元素的赝势； **案例:** task = scf -------------------------------------------------------------------------------------------------------------------------------------------- .. _sys.structure: **参数名称:** :guilabel:`sys.structure` **默认值:** atoms.as **可选值:** XXX.as /XXX.json **描述：** ``sys.structure`` 参数设置结构文件的路径，结构文件可以是.as格式或.json格式，支持绝对路径和相对路径；使用DS-PAW进行结构弛豫之后会生成 ``relax.json`` 文件，可以直接设置sys.structure为 **relax.json** 即可读取结构弛豫的文件进行计算； **案例:** task = scf -------------------------------------------------------------------------------------------------------------------------------------------- .. _sys.symmetry: **参数名称:** :guilabel:`sys.symmetry` **默认值:** true **可选值:** true/false **描述：** ``sys.symmetry`` 该参数表示DS-PAW计算时是否进行对称性分析； **案例:** sys.symmetry = false -------------------------------------------------------------------------------------------------------------------------------------------- .. _sys.functional: **参数名称:** :guilabel:`sys.functional` **默认值:** LDA **可选值:** LDA/PBE **描述：** ``sys.functional`` 参数指定DS-PAW的泛函类型，如果 **sys.functional=LDA** 则会去读取指定路径下的LDA赝势；（ ``sys.functional`` 优先级低于结构文件的Pot选项） **案例:** sys.functional = PBE -------------------------------------------------------------------------------------------------------------------------------------------- .. _sys.spin: **参数名称:** :guilabel:`sys.spin` **默认值:** none **可选值:** none/collinear **描述：** ``sys.spin`` 参数指定计算的自旋性质； **none** 表示没有自旋， **collinear** 表示共线自旋； **案例:** sys.spin = collinear -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.iniCharge: **参数名称:** :guilabel:`cal.iniCharge` **默认值:** 无 **可选值:** 指定rho.bin文件路径 **描述：** ``cal.iniCharge`` 参数表示用户可以通过指定DS-PAW自洽或结构弛豫计算得到的电荷密度文件 **rho.bin** 的路径进行后续的计算； **task=scf/relax** 时，如果不需要读取上一次的电荷密度时则不设置 ``cal.iniCharge`` ，如果需要如果读取上一次的电荷密度时则设置cal.iniCharge； 当task= dos/band/potential/elf时必须设置 ``cal.iniCharge`` 指定 **rho.bin** 的路径；文件路径支持相对路径和绝对路径； **案例:** cal.iniCharge = /home/exp/rho.bin -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.iniWave: **参数名称:** :guilabel:`cal.iniWave` **默认值:** 无 **可选值:** 指定wave.bin文件路径 **描述：** ``cal.iniWave`` 参数表示用户可以通过指定DS-PAW自洽或结构弛豫计算得到的波函数文件 **wave.bin** 的路径进行后续的后续的计算；不设置此参数则表示不读取 **wave.bin** ；文件路径支持相对路径和绝对路径； **案例:** cal.iniWave = /home/exp/wave.bin -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.cutoffFactor: **参数名称:** :guilabel:`cal.cutoffFactor` **默认值:** 1.0 **可选值:** real **描述：** ``cal.cutoffFactor`` 表示截断能参数cal.cutoff的系数，当 **cal.cutoffFactor=2** 时，DS-PAW计算时使用的截断能将会时cal.cutoff*2； **案例:** cal.cutoffFactor = 1.5 -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.cutoff: **参数名称:** :guilabel:`cal.cutoff` **默认值:** 当前计算所用的元素赝势中截断能的最大值； **可选值:** real **描述：** ``cal.cutoff`` 参数表示DS-PAW软件计算时候使用的平面波基矢的截断能； **案例:** cal.cutoff = 300 -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.methods: **参数名称:** :guilabel:`cal.methods` **默认值:** 1 **可选值:** 1/2 **描述：** ``cal.methods`` 表示自洽电子部分优化的方法， ``BM(block Davidson)`` 方法 / ``RM`` (residual minimization)方法； **案例:** cal.methods = 2 -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.smearing: **参数名称:** :guilabel:`cal.smearing` **默认值:** 1 **可选值:** 1/2/3/4 **描述：** ``cal.smearing`` 表示用何种方法来设置每个波函数的部分占有数Gaussian smearing/Fermi-smearing/Methfessel-Paxton order 1/tetrahedron method with Blochl corrections； **案例:** cal.smearing = 2 -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.sigma: **参数名称:** :guilabel:`cal.sigma` **默认值:** 0.2 **可选值:** real **描述：** ``cal.sigma`` 表示使用有限温度方法设置部分占有数时的展宽； **案例:** cal.sigma = 0.01 -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.kpoints: **参数名称:** :guilabel:`cal.kpoints` **默认值:** [1,1,1] **可选值:** 3*1 int array **描述：** ``cal.kpoints`` 表示DS-PAW设置布里渊区k点网格取样大小； **案例:** cal.kpoints = [9,9,9] -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.ksamping: **参数名称:** :guilabel:`cal.ksamping` **默认值:** MP **可选值:** MP/G **描述：** ``cal.ksamping`` 表示DS-PAW自动生成布里渊区k点网格的方法， ``Monhkorst-Pack`` 方法/ ``Gamma centered`` 方法； **案例:** cal.ksamping = G -------------------------------------------------------------------------------------------------------------------------------------------- .. _cal.toalBands: **参数名称:** :guilabel:`cal.toalBands` **默认值:** 与体系价电子数目相关 **可选值:** int **描述：** ``cal.totalBands`` 表示DS-PAW计算中所包含的总能带数目； **案例:** cal.totalBands = 100 -------------------------------------------------------------------------------------------------------------------------------------------- ********************************************************************** .. _io.charge: **参数名称:** :guilabel:`io.charge` **默认值:** true **可选值:** true/false **描述：** 输出电荷密度的二进制文件 ``rho.bin`` 和 ``rho.json文件`` ；当io.charge=true时，生成 ``rho.bin`` 和 ``rho.json文件`` ；当task=scf/realx时该参数可以选择 **true/false** ；当task= dos/band/potential/elf时，io.charge强制为 **false** ； **案例:** io.charge = true -------------------------------------------------------------------------------------------------------------------------------------------- .. _io.elf: **参数名称:** :guilabel:`io.elf` **默认值:** false **可选值:** false/true **描述：** 输出ELF的数据结果；当task=scf/realx时该参数可以选择 **true/false** ；当task= dos/band/potential时，io.elf强制为 **false** ；当task=elf时，io.elf强制为 **true** ； **案例:** io.elf = true -------------------------------------------------------------------------------------------------------------------------------------------- .. _io.potential: **参数名称:** :guilabel:`io.potential` **默认值:** false **可选值:** false/true **描述：** 输出势函数的数据结果；当task=scf/realx时该参数可以选择 **true/false** ；当task= dos/band/elf时，io.potential强制为 **false** ；当task=potential时，io.potential强制为 **true** ；当io.potential=true时，可以选择 ``potential.type`` 来设置输出势函数的类型； **案例:** io.potential = true -------------------------------------------------------------------------------------------------------------------------------------------- .. _io.wave: **参数名称:** :guilabel:`io.wave` **默认值:** false **可选值:** false/true **描述：** 输出波函数的二进制文件 ``wave.bin`` ；当io.wave=true时，生成 ``wave.bin`` 文件；当task=scf/realx时该参数可以选择 **true/false** ；当task= dos/band/potential/elf时，io.wave强制为 **false** ； **案例:** io.wave = true -------------------------------------------------------------------------------------------------------------------------------------------- .. _scf.max: **参数名称:** :guilabel:`scf.max` **默认值:** 60 **可选值:** int **描述：** ``scf.max`` 表示DS-PAW自洽计算时电子步的最大步数； **案例:** scf.max = 30 -------------------------------------------------------------------------------------------------------------------------------------------- .. _scf.min: **参数名称:** :guilabel:`scf.min` **默认值:** 2 **可选值:** int **描述：** ``scf.min`` 表示DS-PAW自洽计算时电子步的最少步数； **案例:** scf.min = 5 -------------------------------------------------------------------------------------------------------------------------------------------- .. _scf.mixBeta: **参数名称:** :guilabel:`scf.mixBeta` **默认值:** 0.4 **可选值:** real **描述：** ``scf.mixBeta`` 表示DS-PAW自洽计算时电子混合算法的Beta值； **案例:** scf.mixBeta = 0.2 -------------------------------------------------------------------------------------------------------------------------------------------- .. _scf.mixType: **参数名称:** :guilabel:`scf.mixType` **默认值:** Broyden **可选值:** Broyden **描述：** ``scf.mixType`` 表示DS-PAW自洽计算时电子混合算法的类型，目前只支持 **Broyden方法** ； **案例:** scf.mixType = Broyden -------------------------------------------------------------------------------------------------------------------------------------------- .. _scf.convergence: **参数名称:** :guilabel:`scf.convergence` **默认值:** 1.0e-4 **可选值:** real **描述：** ``scf.convergence`` 表示DS-PAW自洽计算时，能量的收敛判据； **案例:** scf.convergence = 1.0e-4 -------------------------------------------------------------------------------------------------------------------------------------------- .. _relax.max: **参数名称:** :guilabel:`relax.max` **默认值:** 60 **可选值:** int **描述：** ``relax.max`` 表示DS-PAW结构驰豫时，最大的离子步步数； **案例:** relax.max = 30 -------------------------------------------------------------------------------------------------------------------------------------------- .. _relax.freedom: **参数名称:** :guilabel:`relax.freedom` **默认值:** atom **可选值:** atom **描述：** ``relax.freedom`` 表示DS-PAW结构驰豫的自由度，目前只支持驰豫原子； **案例:** relax.freedom = atom -------------------------------------------------------------------------------------------------------------------------------------------- .. _relax.methods: **参数名称:** :guilabel:`relax.methods` **默认值:** CG **可选值:** CG **描述：** ``relax.methods`` 表示DS-PAW结构驰豫的方法，目前只支持 **CG共轭梯度方法** ； **案例:** relax.methods = CG -------------------------------------------------------------------------------------------------------------------------------------------- .. _relax.forceConvergence: **参数名称:** :guilabel:`relax.forceConvergence` **默认值:** 0.05 **可选值:** real **描述：** ``relax.forceConvergence`` 表示DS-PAW结构驰豫时，原子受力的收敛判据； **案例:** relax.forceConvergence = 0.1 -------------------------------------------------------------------------------------------------------------------------------------------- .. _relax.stepRange: **参数名称:** :guilabel:`relax.stepRange` **默认值:** 0.5 **可选值:** real **描述：** ``relax.stepRange`` 表示结构驰豫时，结构驰豫的中的缩放常数； **案例:** relax.stepRange = 0.2 -------------------------------------------------------------------------------------------------------------------------------------------- .. _dos.range: **参数名称:** :guilabel:`dos.range` **默认值:** [-10,10] **可选值:** 2*1 array **描述：** ``dos.range`` 表示当task=dos时，态密度计算能量的区间； **案例:** dos.range = [-15,15] -------------------------------------------------------------------------------------------------------------------------------------------- .. _dos.resolution: **参数名称:** :guilabel:`dos.resolution` **默认值:** 0.05 **可选值:** real **描述：** ``dos.resolution`` 表示当task=dos时，态密度计算能量间隔精度； **案例:** dos.resolution = 0.1 -------------------------------------------------------------------------------------------------------------------------------------------- .. _dos.project: **参数名称:** :guilabel:`dos.project` **默认值:** false **可选值:** false/true **描述：** ``dos.project`` 参数控制着投影态密度；当task=dos时dos.project为 **false/true** ；其他时候dos.project= false；此时 ``dos.json`` 中将会保存投影态密度的信息； **案例:** dos.project = true -------------------------------------------------------------------------------------------------------------------------------------------- .. _dos.EfShift: **参数名称:** :guilabel:`dos.EfShift` **默认值:** false **可选值:** false/true **描述：** ``dos.EfShift`` 参数表示 ``dos.range`` 的两个能量是否按照自洽的费米能级平移；当dos.EfShift=fasle，则 ``dos.range`` 的能量不按照费米能级平移；当dos.EfShift=true，则 ``dos.range`` 的能量按照费米能级平移； **案例:** dos.EfShift = true -------------------------------------------------------------------------------------------------------------------------------------------- .. _band.kpointsLabel: **参数名称:** :guilabel:`band.kpointsLabel` **默认值:** 无 **可选值:** n*1 string array **描述：** 该参数只有在task=band时才能生效； ``band.kpointsLabel`` 为能带计算时高对称点标签, band.kpointsLabel数据大小是band.kpointsCoord 数据大小的 **1/3** ；比band.kpointsNumber数据大小多 **1** ； **案例:** band.kpointsLabel = [G,M,K,G] -------------------------------------------------------------------------------------------------------------------------------------------- .. _band.kpointsCoord: **参数名称:** :guilabel:`band.kpointsCoord` **默认值:** 无 **可选值:** 3n*1 real array **描述：** 该参数只有在task=band时才能生效； **band.kpointsCoord** 为能带计算时高对此点的分数坐标, band.kpointsCoord 数据大小是band.kpointsLabel数据大小的 **3倍** ； **案例:** band.kpointsCoord = [0, 0, 0, 0.5, 0.5, 0.5, 0, 0, 0.5, 0, 0, 0] -------------------------------------------------------------------------------------------------------------------------------------------- .. _band.kpointsNumber: **参数名称:** :guilabel:`band.kpointsNumber` **默认值:** 无 **可选值:** (n-1)*1 int array **描述：** 该参数只有在task=band时才能生效； **band.kpointsNumber** 为能带每相邻两个高对称点的间隔， ``band.kpointsNumber`` 比 ``band.kpointsLabel`` 数据大小少 **1** ； **案例:** band.kpointsNumber = [5, 5, 5] -------------------------------------------------------------------------------------------------------------------------------------------- .. _band.project: **参数名称:** :guilabel:`band.project` **默认值:** false **可选值:** false/true **描述：** ``band.project`` 参数控制着投影能带；当task=band时band.project= false/true；其他时候band.project= false；此时 ``band.json`` 中将会保存投影能带的信息； **案例:** band.project = true -------------------------------------------------------------------------------------------------------------------------------------------- .. _potential.type: **参数名称:** :guilabel:`potential.type` **默认值:** total **可选值:** total/hartree/all **描述：** ``potential.type`` 只有在task=scf/realx时，io.potential=true时或者task=potential时才会生效；当potential.type为total时，potental.json中输出总的静电式，当为 **hartree** 时， ``potental.json`` 中输出hartree势，当为all时， ``potental.json`` 中同时输出两个势； **案例:** potential.type = all